バックエンド開発Handbookを届けるために ― AI時代の知の高速道路を敷く - Timee Product Team Blog
バックエンド開発Handbookを届けるために ― AI時代の知の高速道路を敷く - Timee Product Team Blog
バックエンド開発HandbookをAIエージェント向けスキルとして届ける取り組みの全体像
目的
暗黙知の形式知化とアクセス性向上の実現
AI時代における知の高速道路の構築
Handbook概要
設計・実装・運用を網羅したガイドライン集
GitHub Pagesとアクセス制御による社内限定公開
戦略的プログラミング・概念モデリング・テーブル設計などの判断基準の体系化
背景
事業成長に伴うエンジニア増加
越境開発の増加とAIツールの普及
チーム固有知識の共有ニーズの高まり
スキル提供方針
AIエージェント経由でガイドラインを自動参照
Claude Code PluginとCursor Agent Skillsで配布
気づいたらガイドラインに沿っている状態の実現
スキル技術設計
Handbook原文とスキル定義の同一リポジトリ管理
Reference SkillsとWorkflow Skillsの二層構造
context: forkによるサブエージェントでの原文取得
gh apiでのマークダウン原文の直接取得
Reference Skills
Handbook各ページと1対1対応
Web API設計・テーブル設計・クラス設計など
メインセッションのコンテキスト節約に寄与
Workflow Skills
理解・モデリング・計画・実装の4フェーズ
Reference Skillsの動的選択
抽象→具体の段階的進行
スラッシュコマンド1つで一気通貫の支援
二層構造のメリット
再利用性
動的選択
コンテキスト効率
チーム固有ワークフローへの拡張性
人間理解を置き去りにしない設計
AI-DLCの前提である人間の妥当性判断を重視
イントロダクションでなぜを説明
ガイドラインURLの提示で原文回帰を促す
抽象→具体の段階的学習
学習ポイントの明示による思考支援